home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / rmtops.z / rmtops
Text File  |  1998-10-20  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4. RRRRMMMMTTTTOOOOPPPPSSSS((((3333))))                                                            RRRRMMMMTTTTOOOOPPPPSSSS((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rmtops - remote tape drive access routines
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiinnnntttt rrrrmmmmttttaaaacccccccceeeessssssss((((cccchhhhaaaarrrr ****ppppaaaatttthhhh,,,, iiiinnnntttt aaaammmmooooddddeeee))));;;;
  13.      iiiinnnntttt rrrrmmmmttttcccclllloooosssseeee((((iiiinnnntttt ffffiiiillllddddeeeessss))));;;;
  14.      iiiinnnntttt rrrrmmmmttttccccrrrreeeeaaaatttt((((cccchhhhaaaarrrr ****ppppaaaatttthhhh,,,, iiiinnnntttt mmmmooooddddeeee))));;;;
  15.      iiiinnnntttt rrrrmmmmttttffffssssttttaaaatttt((((iiiinnnntttt ffffiiiillllddddeeeessss,,,, ssssttttrrrruuuucccctttt ssssttttaaaatttt ****bbbbuuuuffff))));;;;
  16.      iiiinnnntttt rrrrmmmmttttiiiiooooccccttttllll((((iiiinnnntttt ffffiiiillllddddeeeessss,,,, iiiinnnntttt rrrreeeeqqqquuuueeeesssstttt,,,, iiiinnnntttt aaaarrrrgggg))));;;;
  17.      iiiinnnntttt rrrrmmmmttttooooppppeeeennnn((((cccchhhhaaaarrrr ****ppppaaaatttthhhh,,,, iiiinnnntttt ooooffffllllaaaagggg,,,, iiiinnnntttt mmmmooooddddeeee))));;;;
  18.      iiiinnnntttt rrrrmmmmttttrrrreeeeaaaadddd((((iiiinnnntttt ffffiiiillllddddeeeessss,,,, cccchhhhaaaarrrr ****bbbbuuuuffff,,,, uuuunnnnssssiiiiggggnnnneeeedddd iiiinnnntttt nnnnbbbbyyyytttteeee))));;;;
  19.      iiiinnnntttt rrrrmmmmttttwwwwrrrriiiitttteeee((((iiiinnnntttt ffffiiiillllddddeeeessss,,,, cccchhhhaaaarrrr ****bbbbuuuuffff,,,, uuuunnnnssssiiiiggggnnnneeeedddd iiiinnnntttt nnnnbbbbyyyytttteeee))));;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _R_m_t_o_p_s provides a simple means of transparently accessing tape drives on
  23.      remote machines over a network, via _r_s_h(1) and _r_m_t(1M).  This version of
  24.      the library expects the remote _r_m_t program to be version 2, which is
  25.      fairly widespread.  These routines are used like their corresponding
  26.      system calls, but allow the user to open up a tape drive on a remote
  27.      system on which he or she has an account and the appropriate remote
  28.      permissions.  rmtaccess() always returns 0 in the remote case, since the
  29.      protocol doesn't support this concept, deferring access errors until the
  30.      rmtopen or rmtcreat.
  31.  
  32.      A remote tape drive file name has the form
  33.  
  34.           [user@]_s_y_s_t_e_m:/_d_e_v/???
  35.  
  36.      where _s_y_s_t_e_m is the remote system, /_d_e_v/??? is the particular drive on
  37.      the remote system (raw, blocked, rewinding, non-rewinding, etc.), and the
  38.      optional _u_s_e_r is the login name to be used on the remote system, if
  39.      different from the current user's login name.  This corresponds to the
  40.      remote syntax used by _r_c_p(1).  Note that the remote device must in fact
  41.      be a device, and must reside below /dev on the remote system.
  42.  
  43.      The routines differentiate between local and remote file descriptors by
  44.      adding a bias to the file descriptor of the pipe.  The programmer, if he
  45.      must know if a file is remote, should use the _i_s_r_m_t function.  Up to 4
  46.      remote devices may be in simultaneous use by one program at the same
  47.      time.
  48.  
  49. FFFFIIIILLLLEEEESSSS
  50.      ////uuuussssrrrr////lllliiiibbbb////lllliiiibbbbrrrrmmmmtttt....aaaa
  51.           Contains the remote tape library.  To include the library with a
  52.           program, add the flag -_l_r_m_t to the _c_c(1) command line.
  53.  
  54. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  55.      _r_c_p(1), _r_s_h(1), _r_m_t(2), and the appropriate system calls in section 2.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RRRRMMMMTTTTOOOOPPPPSSSS((((3333))))                                                            RRRRMMMMTTTTOOOOPPPPSSSS((((3333))))
  71.  
  72.  
  73.  
  74. DIAGNOSTICS
  75.      Several of these routines will return -1 and set _e_r_r_n_o to EOPNOTSUPP, if
  76.      they are given a remote file name or a file descriptor on an open remote
  77.      file (e.g., _r_m_t_d_u_p).
  78.  
  79. BBBBUUUUGGGGSSSS
  80.      See diagnostics above.  It is to be hoped that true remote file systems
  81.      will eventually appear, and eliminate the need for these routines.
  82.  
  83.      There is no way to use remote tape drives with the _s_t_d_i_o(3) package with
  84.      the current implementation.
  85.  
  86.      The _r_m_t(1m) protocol is not very capable.  In particular, it relies on
  87.      TCP/IP sockets for error free transmission, and does no data validation
  88.      of its own.
  89.  
  90.      The _r_m_t program allows no more than 10K bytes to be transferred at one
  91.      time.  The rmtread and rmtwrite routines will transfer data in multiple
  92.      chunks if necessary to meet this requirement, and the rmt program on the
  93.      remote will reassemble the data and pass it via the read and write system
  94.      calls as a single system call.
  95.  
  96. OOOORRRRIIIIGGGGIIIINNNNAAAALLLL AAAAUUUUTTTTHHHHOOOORRRRSSSS
  97.      This set of routines is passed on a package posted to the Usenet group
  98.      comp.sources.unix, circa 1989.  Further changes, particularly to the
  99.      rmtioctl code, were made at Silicon Graphics.
  100.      Jeff Lee (gatech!jeff) wrote the original routines for accessing tape
  101.      drives via _r_m_t(1m).
  102.  
  103.      Fred Fish (unisoft!fnf) redid them into a general purpose library.
  104.  
  105.      Arnold Robbins (gatech!arnold) added the ability to specify a user name
  106.      on the remote system, this man page, and cleaned up the library a little.
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.